home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: Essential Home & Business / PC-SIG - Essential Home and Business Collection.iso / 22 / 3 / 4 / VPT.MAN < prev   
Text File  |  1989-11-24  |  16KB  |  373 lines
  1.  
  2.  
  3.  
  4.                      ▄▄▄▄  ▄   ▄   ▄  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄  ▄▄▄▄
  5.                      █  ▀  █   █   █  █                █  ▀
  6.                      █     █   █▄▄▄█  █▄▄▄  █▀▄▀█  █   █
  7.                      █     █▄▄▄  █       █  █ █ █  █   █
  8.                      █▄▄█  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄█  █ █ █  █   █▄▄█
  9.  
  10.  
  11.               ┌─────────────────────────────────────────────────┐
  12.               │                                                 │
  13.               │   V I D E O   P A L E T T E   T O O L   V3.50   │
  14.               │                                                 │
  15.               └─────────────────────────────────────────────────┘
  16.  
  17.        Programs and Documentation are Copyright 1989 by clySmic software.
  18.                               All rights reserved.
  19.  
  20.  
  21.      I. INTRODUCTION
  22.  
  23.      This program allows VGA (PS/2 Model 50, 60 or 80), Display Adapter/2,
  24.      BIOS or register compatible VGA clone, or MCGA (PS/2 Model 25 or 30)
  25.      users to:
  26.  
  27.      ■    View the quarter-million color palette they've been hearing
  28.           about,
  29.  
  30.      ■    Set any text-mode attribute (0 - 15) to any color,
  31.  
  32.      ■    Control the overscan (a.k.a. border) color (not available on MCGA
  33.           systems),
  34.  
  35.      ■    Have the colors "stick" with most programs,
  36.  
  37.      ■    Load and save their favorite settings in color files, and
  38.  
  39.      ■    Use the program in a command-line mode.
  40.  
  41.  
  42.      See the end of this document for an important upgrade offer.
  43.  
  44.  
  45.      II. FILES INCLUDED
  46.  
  47.      ■ VPT.EXE................The VGA/MCGA Palette Tool.
  48.      ■ VPT.MAN................This documentation.
  49.      ■ LOCK.COM...............A small TSR that locks EGA and VGA palette
  50.                               registers (optional).
  51.      ■ SEL.EXE................An ANSI color setting program.
  52.      ■ TSTPATN.EXE............A television test pattern to judge colors
  53.                               with.
  54.  
  55.  
  56.  
  57.      III. INTERACTIVE MODE
  58.  
  59.      Command: VPT
  60.  
  61.      VPT operates in text mode and allows setting of any or all of the
  62.      sixteen attributes available in text mode.  There are three sliders
  63.      (one each for Red, Green, and Blue), each of which can assume any of
  64.      64 values (0 through 63).  The current values are displayed next to
  65.      the sliders on the right side of the screen.
  66.  
  67.      Key(s)                   Action
  68.      -----------------        ----------------------------------------
  69.  
  70.      Left/Right Arrows        Moves the R,G, or B slider between 0 and 63
  71.                               to control the intensity of the R, G, or B
  72.                               signal.
  73.  
  74.      Control Left/Right       As above, but moves five positions instead of
  75.                               one.
  76.  
  77.      PageUp/PageDown          Selects an attribute between 0 and 15 to work
  78.                               with.
  79.  
  80.      A                        Shows licensing information About VPT.
  81.  
  82.      B                        Backdrop mode.  This makes the current
  83.                               attribute the background and places text with
  84.                               all sixteen attributes on the screen so you
  85.                               can see the combinations.  Any key exits this
  86.                               mode.
  87.  
  88.      D                        Loads the Default, boot-up colors.
  89.  
  90.      L                        Loads the colors from a file of your choice,
  91.                               if no file is specified, STD.VPT is assumed.
  92.                               You don't need to add the .VPT extension.
  93.  
  94.      O                        Sets the Overscan (border) color to the
  95.                               current attribute.  Not available on MCGA
  96.                               systems.
  97.  
  98.      S                        Saves the colors to a file of your choice, if
  99.                               no file is specified, STD.VPT is assumed.
  100.                               Note: all .VPT files are saved to the
  101.                               directory VPT is found in, NOT the current
  102.                               directory (unless VPT.EXE is there!)
  103.  
  104.      T                        Automatically loads the sTandard color file,
  105.                               STD.VPT.  This is the same as Loading it, its
  106.                               just easier.
  107.  
  108.      End                      Exits VPT.
  109.  
  110.      Keys Used While Loading or Saving a File:
  111.  
  112.      Backspace                Erases the last character in the file name.
  113.  
  114.      Ctrl-Backspace           Erases all the characters in the file name.
  115.  
  116.  
  117.      
  118.      IV. COMMAND-LINE MODE
  119.  
  120.      Command: VPT [option]
  121.  
  122.      Where [option] is one of the following (capitalization does not
  123.      matter):
  124.  
  125.      /L[filename]             This loads the specified file, if there is
  126.                               one.  If there isn't, you will get an error
  127.                               message.  If [filename] is not specified,
  128.                               STD.VPT will be assumed.
  129.  
  130.      /C[filename]             Like /L above, but does an ANSI clear screen
  131.                               afterwards and displays no messages.
  132.  
  133.      /D                       This loads the default palette.  These are
  134.                               the colors assigned by IBM and are the ones
  135.                               you would see if you didn't use VPT.
  136.  
  137.      /X                       This resets the "palette load on mode change"
  138.                               option to true (see TECHNICAL INFORMATION,
  139.                               below, for an explanation).
  140.  
  141.      /?                       Presents a help list recapping your options.
  142.  
  143.      Any other option will generate an error message.
  144.  
  145.      The main reason for command-line mode is to include VPT in batch
  146.      files.  First you would run VPT interactively, find the colors you
  147.      like, save them in the STD.VPT file, then include a line like the
  148.      following:
  149.  
  150.      VPT /L
  151.  
  152.      in your batch file.  This will load your saved colors when you run the
  153.      batch file.  VPT.EXE should be placed in a directory on your PATH.  If
  154.      you don't wish to see the informational messages produced by VPT in
  155.      command-line mode, you can redirect the output to the null device
  156.      (a.k.a. the bit bucket) as follows:
  157.  
  158.      VPT /L >NUL:
  159.  
  160.      Note that error messages *cannot* be redirected and will still be
  161.      seen.
  162.  
  163.      If there are any errors, the DOS ERRORLEVEL is set to 10.
  164.  
  165.      
  166.      V. MORE EXAMPLES
  167.  
  168.      VPT /L123PAL             Loads the color file 123PAL.VPT.  This
  169.                               assumes you created such a file using the
  170.                               interactive mode of VPT.
  171.  
  172.      VPT /C                   Loads STD.VPT and clears the screen.
  173.  
  174.      VPT /?                   Brings forth help.
  175.  
  176.  
  177.  
  178.      VI. TECHNICAL INFORMATION
  179.  
  180.      ■ GENERAL
  181.  
  182.      VPT works by making BIOS calls that manipulate the DAC (digital to
  183.      analog converter) color registers; each register (there are 256, to
  184.      allow for the 300x200x256 mode) contains 18 bits, 6 each for Red,
  185.      Green, and Blue.  Each RGB value can go from 0 to 63, all the
  186.      combinations makes for 262,144 possible colors.  You can show up to
  187.      sixteen of these at a time in the text modes, each of the sixteen
  188.      "attributes" can be any color (or all the same color) out of the
  189.      quarter-million.
  190.  
  191.      ■ MODE SETS
  192.  
  193.      Normally BIOS resets the EGA and DAC color registers whenever a mode
  194.      set is done.  VPT makes its colors stick across a mode change by using
  195.      the "Default Palette Loading During Mode Set" BIOS call to disable
  196.      this action.  If, for some reason, you desire to return this to its
  197.      default, boot-up condition, use VPT /X.  Then a subsequent mode
  198.      change, like MODE CO80, will cause the default conditions to prevail.
  199.  
  200.      ■ REGISTERS, REGISTERS EVERYWHERE
  201.  
  202.      ON the VGA, the DAC color registers are mapped through the EGA palette
  203.      registers, so, for instance, the attribute "Brown" (6) maps to the
  204.      color $14 on an EGA (out of its 64 possible colors); on the VGA, DAC
  205.      color register $14 contains $2A,$15,$00 for the R, G, and B values
  206.      (these are all default values).
  207.  
  208.      In order to not to be foiled by EGA-aware programs, VPT resets the EGA
  209.      palette registers to their default values each time it is run.  If a
  210.      program remaps the EGA registers, and then counts on a mode set to
  211.      return them to normal when it exits, the registers will *stay*
  212.      remapped because of the disabling of the "palette load on mode set".
  213.      Simply type VPT /C (for instance) and it will remap the EGA registers
  214.      to their default values.
  215.  
  216.      Note that EGA-aware programs will still use their own colors while the
  217.      program is running, VPT doesn't prevent that.
  218.  
  219.      The MCGA has no EGA registers, so the DAC registers are set directly
  220.      from the color attribute.
  221.  
  222.      ■ COLOR FILES
  223.  
  224.      The saved color files have an extension of .VPT which you NEVER need
  225.      to type when using VPT.
  226.  
  227.      For DOS 3.x users, they are stored in the same directory that VPT is
  228.      run from.  For instance, say VPT is stored in the C:\BIN directory,
  229.      that directory is on your PATH, and you are in C:\ZUUL.  The color
  230.      file will be stored in C:\BIN.  For DOS 2.x users, the file will be
  231.      stored in the root directory.  DOS 1.x users are quite out of luck,
  232.      why would one have advanced video but DOS 1.x anyway?
  233.  
  234.      VPT attempts to check for a valid color file by not loading any files
  235.      that aren't exactly 49 bytes long.  You will get a 'bad color file'
  236.      message.  If a file is 49 bytes long and has a .VPT extension but
  237.      *isn't* a VPT color file, it will get loaded anyway.  The colors
  238.      should be interesting.
  239.  
  240.      ■ REFERENCES
  241.  
  242.      VPT was written based on technical information from the book
  243.      "Programmer's Guide to PC & PS/2 Video Systems" by Richard Wilton and
  244.      IBM's Display Adapter/2 Technical Reference.
  245.  
  246.      
  247.      VII. CAVEATS
  248.  
  249.      EGA-aware and VGA-aware programs still will run with their own colors,
  250.      all (okay, almost all, who knows what's out there?) other programs
  251.      will use the colors VPT sets.
  252.  
  253.      VPT uses only BIOS calls and should run on the BIOS or register
  254.      compatible VGA clones that are now just becoming available; however,
  255.      the pseudo-VGAs (really EGAs with 640x480 mode) won't run it - they
  256.      still have only 64 colors total (and will cause grief down the road
  257.      for their buyers, I suspect).  The author welcomes any VGA clone test
  258.      results.
  259.  
  260.      
  261.      VIII. OTHER INCLUDED PROGRAMS
  262.  
  263.      ■ LOCK.COM
  264.  
  265.      If you want to "lock" the colors you set against any EGA/VGA-aware
  266.      programs that try to change them using BIOS, set your colors, then run
  267.      the TSR program LOCK.COM included in this package.  This program can
  268.      be removed and re-run by using a TSR control package like TurboPower's
  269.      excellent MARK and RELEASE (available on CompuServe and probably
  270.      everywhere else).  Note: VPT will not be able to reset your colors
  271.      after LOCK is run.  To reset them, remove LOCK, reset, then run LOCK
  272.      again.
  273.  
  274.      ■ TSTPATN.EXE
  275.  
  276.      This is a silly program that displays a test pattern to see what
  277.      various colors look like with lots of text and various lines on the
  278.      screen.  Also great for leaving on your screen all night.  This
  279.      program takes its colors from the DOS screen colors when its invoked.
  280.      Works best if you use something like ANSI.SYS or have LightGray and
  281.      Black re-mapped to different colors.
  282.  
  283.      ■ SEL.EXE
  284.  
  285.      A small ANSI color selector for those who use ANSI.SYS or a similar
  286.      ANSI screen driver.  Allows easy color selection using the BIOS/BASIC
  287.      color numbering scheme instead of the ANSI color numbers.  Type SEL /?
  288.      for instructions.
  289.  
  290.  
  291.      IX. ENHANCED VERSION
  292.  
  293.      There is a commercial, non-shareware version of VPT available direct
  294.      from clySmic - VPT 4.10.  Here are some of VPT 4.10's features:
  295.  
  296.      1.   Much faster color loading, due to direct access to
  297.           the DAC registers, rather than going through the
  298.           BIOS.  The BIOS calls are either slow or cause severe
  299.           flickering.
  300.  
  301.      2.   A completely new and improved method to get the colors
  302.           to "stick" for all programs.  This involves a very small
  303.           (0.8K) terminate-and-stay-resident program called
  304.           VPTRES.  MCGA users and those who don't want a TSR
  305.           program resident can still use VPT 4.10 in the old
  306.           manner, without VPTRES.  It is highly recommended though
  307.           as an improved way of controlling colors.  It solves the
  308.           problem of exiting from an application that uses EGA
  309.           colors and/or graphics.  In the past you had to re-run
  310.           VPT to restore normal colors.  Now VPTRES takes care of
  311.           all that automatically!
  312.  
  313.      3.   During color file loading you can press F1 for a list of
  314.           all available .VPT color files in the directory that VPT
  315.           was run from.  No more having to remember what name you
  316.           gave to a .VPT color file!  You can easily scroll back
  317.           and forth through this list and select a file for
  318.           loading with one key.
  319.  
  320.      4.   Home and End now adjust the color of the slider you're
  321.           working on, Home for 0 and End for 63.  X or Escape is
  322.           now used to exit VPT.
  323.  
  324.      5.   Built-in integrity checking.  This option allows you to
  325.           run an integrity check on VPT.EXE to make sure it hasn't
  326.           been corrupted for by a virus or a disk/software
  327.           failure.  Be safe!
  328.  
  329.      VPT 4.10 can be ordered by sending $20.00 to clySmic software, our
  330.      address is below.  Please make checks or money orders payable to
  331.      Ralph B. Smith Jr.
  332.  
  333.  
  334.      X. ALL THAT LEGAL BROUHAHA
  335.  
  336.      VPT is copyrighted by clySmic software, and is released as Shareware.
  337.      It is requested that if you find this program useful, that you send
  338.      clySmic software $20.00 as a user fee FOR EACH MACHINE USED.
  339.  
  340.      You may copy this program and distribute it without charge for non-
  341.      commercial, non-governmental use.  You may not sell or otherwise
  342.      charge for VPT.  However, users' groups may charge a small fee (not to
  343.      exceed $7) for media and postage.  Commercial and governmental users
  344.      are REQUIRED to pay the user fee.  Please be certain that all files
  345.      are kept together.
  346.  
  347.      This program is provided AS IS without any warranty, expressed or
  348.      implied, including but not limited to fitness for a particular
  349.      purpose.  So there.
  350.  
  351.      clySmic software is not responsible for anything that may happen when
  352.      you use VPT, including hardware damage or information loss.
  353.  
  354.      Please make checks or money orders payable to Ralph B Smith Jr.
  355.  
  356.      Payments may be sent to:
  357.  
  358.                                 Ralph B Smith Jr
  359.                                 clySmic software
  360.                                  P. O. Box 2271
  361.                                Empire State Plaza
  362.                                 Albany, NY 12220
  363.  
  364.      Thank you.  This will allow more improvements to VPT, and will allow
  365.      other products to come your way.
  366.  
  367.  
  368.  
  369.                                                              -- Ralph Smith
  370.                                                                  President,
  371.                                                            clySmic software
  372.                                                    CompuServe No. 76156,164
  373.